home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Hottest 6
/
Hottest 6 (1996)(PDSoft)[!].iso
/
software
/
emulators
/
over5
/
doc
/
over5.doc
< prev
next >
Wrap
Text File
|
1978-11-24
|
8KB
|
318 lines
Documentation for Over5 0.463 by Daniel Kahlin <tlr@stacken.kth.se>
-----------------------------------------------------------------------------
Distribution:
Over5 is FREEWARE (Freely-Distributable), but copyrighted by me. (NOT PD!)
None of the included files may be modified and/or removed. Permission is
given to freely distribute this program provided you include all files from
the original archive, and no fee is charged in excess of reasonable media
and mailing costs. The program may not be used for commercial purposes
without written permission from the author.
Disclaimer:
I cannot in any way be held responsible for anything this program does.
You are using it entirely at your own risk. Every effort has been made to
keep this program bug free. But, IF for example a bug exists that blows up
your entire computer, don't blame me.
-----------------------------------------------------------------------------
GENERAL:
Over5 (the successor to OverFour) is an AMIGA to/from C64 transfer program
package. It was made because of too many burnt 6526's and 8520's. To overcome
that problem I chose to use a standard RS-232 interface.
Over5 contains several commands: COPY, WRITEFILE, READFILE, WRITEMEM, READMEM,
SYS, SIMPLEWRITE, SIMPLEREAD, BOOT, DIR, STATUS, COMMAND, WRITEDISK, READDISK,
WRITEZIP, READZIP, TEST, SERVER, HELP.
Documentation:
command COPY:
-------------
TEMPLATE: Over5 COPY FROM/M,TO/A,DEBUG/S
FROM/M source file/files
TO/A destination file/path
DEBUG/S sets debug mode (shows all packets).
copies source to destination (like AmigaDOS copy) but '8:' is the 1541.
The wildcard '*' can be used. (no wildcards on amigafiles, SORRY!)
example: copy 8:disksl* ram:
command WRITEFILE:
------------------
(this is a low level command, generally you should use 'COPY' instead)
TEMPLATE: Over5 WRITEFILE FROM/A,TO/A,DEBUG/S
FROM/A source file
TO/A destination file
DEBUG/S sets debug mode (shows all packets).
copies source file from the amiga to the destination file on the 1541.
command READFILE:
-----------------
(this is a low level command, generally you should use 'COPY' instead)
TEMPLATE: Over5 READFILE FROM/A,TO/A,DEBUG/S
FROM/A source file
TO/A destination file
DEBUG/S sets debug mode (shows all packets).
copies source file from the 1541 to the destination file on the amiga.
command WRITEMEM:
------------------
TEMPLATE: Over5 WRITEMEM FROM/A,RUN/S,RESET/S,DEBUG/S
FROM/A source file
RUN/S execute file with 'RUN' after transfer.
RESET/S do reset on the c64 before transfer (with special hardware)
DEBUG/S sets debug mode (shows all packets).
Writes source file into the c64 memory.
command READMEM:
----------------
TEMPLATE: Over5 READMEM START/A,END/A,TO/A,RESET/S,DEBUG/S
START/A start address
END/A end address
TO/A destination file
RESET/S do reset on the c64 before transfer (with special hardware)
DEBUG/S sets debug mode (shows all packets).
Reads c64 memory between START and END to the destination file.
command SYS:
------------
TEMPLATE: Over5 SYS PC/A,MEMORY,SR,AC,XR,YR,SP,RESET/S,DEBUG/S
PC/A programcounter
MEMORY contents of $01 (default 0x37)
SR status register (default 0x00)
AC Accumulator (default 0x00)
XR X index register (default 0x00)
YR Y index register (default 0x00)
SP Stack pointer (default 0xff)
RESET/S do reset on the c64 before sys (with special hardware)
DEBUG/S sets debug mode (shows all packets).
Starts code beginning at pc.
command SIMPLEWRITE:
--------------------
TEMPLATE: Over5 SIMPLEWRITE FROM/A,OLD/S
FROM/A source file
OLD/S obsolete protocol. use for FastRS 1.1 or earlier
Writes source file into the c64 memory using the simpleprotocol.
(no handshaking)
command SIMPLEREAD:
-------------------
TEMPLATE: Over5 SIMPLEREAD TO/A,OLD/S
TO/A destination file
OLD/S obsolete protocol. Use this for FastRS 1.1 or earlier.
Reads source file from the c64 memory using the simpleprotocol.
(no handshaking)
command BOOT:
-------------
(this is only used to transfer 'DiskSlave' or similar for the first time)
TEMPLATE: Over5 BOOT FROM/A
FROM/A source file
First it relocates the source file to $c000-len and appends 'copytail',
then it sends the file at 150 baud to the c64. (no handshaking)
Works together with the basic program 'boot.asc'.
When transferred, just type 'SYS 49152<CR>' and save to DISK or TAPE.
command DIR:
------------
TEMPLATE: Over5 DIR DEBUG/S
DEBUG/S sets debug mode (shows all packets).
Reads directory from the 1541 and shows it.
command STATUS:
---------------
TEMPLATE: Over5 STATUS DEBUG/S
DEBUG/S sets debug mode (shows all packets).
Gets diskstatus from 1541 and shows it.
command COMMAND:
----------------
TEMPLATE: Over5 COMMAND COMMAND/A,DEBUG/S
COMMAND/A diskcommand
DEBUG/S sets debug mode (shows all packets).
Sends a diskcommand to the 1541.
command TEST:
-------------
(this command is not necessary for the ordinary user)
TEMPLATE: Over5 TEST BLOCK/S,FILE/S,DEBUG/S
BLOCK/S test block transfer
FILE/S test file transfer
DEBUG/S sets debug mode (shows all packets).
Tests block transfer and/or file transfer.
command WRITEDISK:
------------------
TEMPLATE: Over5 WRITEDISK FROM/A,DEBUG/S
FROM/A source diskimage
DEBUG/S sets debug mode (shows all packets).
Writes the source diskimage to the 1541. Diskimages are usually
named '.dsk' or '.d64' and should be 174848 bytes in size.
command WRITEZIP:
-----------------
TEMPLATE: Over5 WRITEZIP FROM/A,DEBUG/S
FROM/A zipcode basename (1!<basename>, 2!<basename>, etc...)
DEBUG/S sets debug mode (shows all packets).
Decodes the zipcode archive and writes the diskimage to the 1541.
command READDISK:
-----------------
TEMPLATE: Over5 READDISK TO/A,DEBUG/S
TO/A destination diskimage
DEBUG/S sets debug mode (shows all packets).
Reads an entire disk from the 1541.
command WRITEZIP:
-----------------
TEMPLATE: Over5 WRITEZIP TO/A,DEBUG/S
TO/A zipcode basename (1!<basename>, 2!<basename>, etc...)
DEBUG/S sets debug mode (shows all packets).
Reads an entire disk from the 1541 and encodes it into a standard
zipcode archive.
This may sometimes produce shorter archives than zipcode, but the
archive will unpack fine on the c64.
command SERVER:
---------------
TEMPLATE: Over5 SERVER DEBUG/S
DEBUG/S sets debug mode (shows all packets).
Sets the amiga in SERVER MODE. Run 'SerFile' on the c64 to use it.
commands (#C"<COMMAND>" or .<COMMAND> in 'SerFile')
.DIR or .$ or $
Displays the files in the current directory.
.CD
Displays the name of the current directory.
.CD <dir>
Set the current directory to <dir>.
command HELP:
-------------
TEMPLATE: Over5 HELP or Over5 ?
Shows small help text.
System requirements:
Over5 should run on any system setup running OS2.04 or higher, although it
has only been tested on an A3000/25 running OS3.1. If you find bugs or have
suggestions about how to make the program better please send a bugreport or
a list of suggestions to the address at the end of this text.
-----------------------------------------------------------------------------
Author:
Daniel Kahlin is a student at the Royal Institute of Technology (Stockholm)
Former c64 demo programmer (1986-1988). He is deeply involved with computers
and electronics.
InterNet: <tlr@stacken.kth.se>
SnailMail: Daniel Kahlin
Vanadisvägen 6, 2tr
s-113 46 Stockholm
Sweden
Phone: 08-34 84 73 (+468348473)
-----------------------------------------------------------------------------